home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 2 / The Arsenal Files 2 (Arsenal Computer).ISO / syncron / note200a.txt < prev    next >
Text File  |  1994-06-06  |  11KB  |  238 lines
  1.  
  2.      Synchronet Multinode BBS Software  Vesion 2.00a  Release Notes
  3.      ==============================================================
  4.  
  5.  
  6. This document was created on 06/06/94 as a general response to the most
  7. frequently asked questions and comments regarding the Synchronet v2.00a
  8. release on 06/02/94.
  9.  
  10.  
  11. Registration Key File
  12. ---------------------
  13. Version 2 requires a different key file from version 1c (to run unregistered).
  14. If your original purchase of Synchronet was on or after August 27th 1993,
  15. you can call our BBS and download a version 2 key file for your current
  16. node license from the Synchronet Upgrade Door. You cannot use the "Guest"
  17. account to download a key file. If your original Synchronet purchase was before
  18. August 27th 1993, you will need to send in an order form. Download V20ORDER.TXT
  19. from our BBS for the pricing and details.
  20.  
  21.  
  22. PCMS and Baja
  23. -------------
  24. PCMS stands for Programmable Command and Menu Structure. It is the technology
  25. implemented in version 2 that allows the sysop a high level of customization
  26. of the user interface. It also allows third parties to develop add-ons or
  27. replacement command shells for the BBS. A command shell is the over-all
  28. look and feel of the BBS. Six command shells were included with the release
  29. of Version 2 - Classic Synchronet, Synchronet Novice, and emulations of
  30. Wildcat, PCBoard, MajorBBS, and Renegade. Expect to see more command shells
  31. and add-on modules for PCMS in the future from Digital Dynamics and other
  32. developers.
  33.  
  34. Baja is the language and compiler included with Synchronet used to create
  35. Command Shells and Modules for Synchronet. Baja will convert a text source
  36. file (.SRC) into a binary executable (.BIN) to use with Synchronet as either
  37. a command shell or plug-in module.
  38.  
  39. Command shells are added via SCFG->Command Shells. Mmodules are added by
  40. editing a command shell source file (.SRC) and adding an EXEC_BIN line to load
  41. and execute a module. Brief information about the instructions and functions
  42. available via Baja are availble in the file DOCS\BAJA.DOC. This file is just a
  43. preliminary reference. A complete user guide is in the works and will be
  44. available for download soon.
  45.  
  46.  
  47. Message Base
  48. ------------
  49. The version 2 message base is more than just a disk-space saver. It is a
  50. technical achievement that will remain reliable and extensible as an e-mail
  51. storage format for many years to come. Development of the version 2 message
  52. base started almost one year ago after close examination and experimentation
  53. with other message formats (including Hudson, JAM, and Squish). It was not
  54. our desire to introduce yet another format if one existed already that was
  55. extensible and reliable enough. Unfortunately (or rather, fortunately) such
  56. a format didn't exist until the formalization of the Synchronet Message Base
  57. (SMB) specification in January of this year.
  58.  
  59. SMB is a public specification that exceeds the capabilities of any other
  60. standard message base format (we could find) and then some. It is fast,
  61. reliable, and extensible. We spent considerable energy writing an 80 page
  62. technical specification and 34 function royalty free C library for other
  63. developers to utilize. It is only a matter of time before the developers of
  64. editors, EchoMail programs, off-line mail doors, network gateways, etc. get
  65. wind of SMB and add support into their product line. The first and foremost of
  66. such developers is Merlin Systems - developing a UUCP/Internet Gateway for
  67. SMB (913-441-1336 voice). Please help out the developers of the products
  68. you use (GEcho, FrontDoor, D'bridge, GoldEd, BlueWave, etc) and encourage them
  69. to add support for SMB. To help them out even further, download SMB_111.ZIP
  70. (the spec and programmers' library) and send it to them. We encourage
  71. developers to call us voice if they have questions about SMB or need
  72. assistance. Complete source code to conversion programs for QWK, Fido, UUCP,
  73. and Synchronet v1c formats are included free - as well as the source to CHKSMB
  74. and SMBUTIL. Which brings me to an important note regarding SMBUTIL.
  75.  
  76.  
  77. SMBUTIL
  78. -------
  79. If you are upgrading from version 1 of Synchronet, you will need to add the
  80. following to SCFG->External Programs->Timed Events:
  81.  
  82. Start-up Dir : ..\DATA
  83. Command line : %!smbutil mp100 mail subs\*.shd
  84.  
  85. The event needs to be set to run EXCLUSIVELY. This will maintain (delete
  86. over-the-max and out-dated messages) and pack the message base (to conserve
  87. disk space). Your message bases will exceed the maximum you have specified in
  88. SCFG, but will be trimmed back down when this event is run. The internal
  89. code used for the event is not significant. If you have a lot of large
  90. capacity message areas (1000 msgs+), you may want to reduce the amount of
  91. time the event spends packing by changing the "mp100" portion of the above
  92. command line to "mp500" or "mp1000". This will not conserve as much disk
  93. space in general, but will cause the event to run quicker by not packing
  94. message bases that will not benefit much (save much space) if compressed.
  95. The "p100" or "p500" specifies to only pack a message base if 100k or 500k
  96. respectively, can be saved. If you want the message base to be packed even if
  97. only 50 bytes can be saved, change the parameter to "mp". If nothing can
  98. be saved by packing, SMBUTIL will not pack the message base.
  99.  
  100. Original installers of v2.00a, should change SCFG->External Programs->
  101. Timed Events->MSGMAINT to be configured as mentioned above.
  102.  
  103. The utility MSGPURGE included with version 1c is obsolete and should not be
  104. used with Version 2 (just delete MSGPURGE.EXE). If you were using MSGPURGE
  105. to speed up your message imports via your QNET or other batch file, you no
  106. longer need this and can delete any reference to MSGPURGE.
  107.  
  108. Also, when you create new message sub-boards, you'll probably want to change
  109. the storage format to "Fast Allocation" from self-packing. There is no
  110. advantage to using Self-Packing method for only some sub-boards and the 1CTO20
  111. conversion utility set all your existing sub-boards to "Fast Allocation".
  112. "Fast Allocation" will be the default storage format in future releases of
  113. SCFG. The "Self-Packing" storage format is slower at importing, but convserves
  114. disk space immediately (rather than waiting until the event). It should only
  115. be used on systems where up-time (non-event time) is more critical than the
  116. speed of importing messages.
  117.  
  118.  
  119. Mail
  120. ----
  121. In version 2, mail is not immediately deleted when you hit the 'D' key. Instead
  122. it is marked as deleted (denoted after the "ATTR:" portion of the message
  123. header) and can be undeleted by hitting 'D' again until you exit mail-read
  124. mode, when the message is physically deleted (and cannot be undeleted).
  125.  
  126.  
  127. Doors from the Main and Transfer Menus
  128. --------------------------------------
  129. The main and transfer command options were removed from the online external
  130. program (door) configuration in SCFG in version 2. To add external programs
  131. and main menu commands in version 2, you must edit the appropriate menu
  132. file (e.g. TEXT\MENU\MAIN.ASC) and then add the command to the shell (.SRC).
  133. Example:
  134.  
  135. cmdkey $
  136.     exec_xtrn DTELLER
  137.         end_cmd
  138.  
  139. The exec_xtrn command executes an external program specified by its internal
  140. code (as listed in SCFG) - "DTELLER" is used in the above example for the '$'
  141. command.
  142.  
  143. After making any changes to a command shell source file (.SRC), you must
  144. recompile with Baja to create the executable binary file (.BIN).
  145.  
  146.  
  147. Sysop Commands
  148. --------------
  149. When "Hot Keys" are disabled from the User Defaults, the ";" commands work
  150. in a strange way. You must hit ';', then enter, then type the command (e.g.
  151. MEM, UPLOAD, DOS, etc.) or you can fix the problem by editing the file
  152. EXEC\DEFAULT.SRC with a text editor and change the following:
  153.  
  154. ------------------------------------------------------------------------------
  155. :str_cmds
  156. getstrupr 40
  157. logstr
  158. ------------------------------------------------------------------------------
  159.  
  160. To this:
  161.  
  162. ------------------------------------------------------------------------------
  163. :str_cmds
  164. compare_user_misc COLDKEYS
  165. if_true
  166.     shift_str 1
  167. else
  168.     getstrupr 40
  169.     end_if
  170. logstr
  171. ------------------------------------------------------------------------------
  172.  
  173. Then recompile the shell by typing "BAJA DEFAULT".
  174.  
  175. This command shell fix (and others) will be made available for download on
  176. our BBS in the near future.
  177.  
  178. If you find something that works different than version 1, you may be able
  179. to fix/change the way it works by editing the command shell and recompiling.
  180. See the included command shell source files (.SRC) for examples.
  181.  
  182. A few of the sysop command were removed/changed on purpose, but some can be
  183. added or changed back to the version 1c way fairly easily. An example is the
  184. ";CHAT" command being removed due to the redundancy on the Chat: prompt. You
  185. can put this command back in the command shell by adding the following lines
  186. in the section titled "cmd_str" in DEFAULT.SRC (if you have done no programming
  187. of any kind, you may not want to mess with this):
  188.  
  189. # Sysop Chat
  190. compare_ars exempt C
  191. if_true
  192.     compare_str "CHAT"
  193.         if_true
  194.         page_sysop
  195.                 end_if
  196.         end_if
  197.  
  198. A Baja command shell/module programming document (as mentioned before) will
  199. be released soon to explain how and why all this works.
  200.  
  201.  
  202. Memory and Message/File Areas
  203. -----------------------------
  204. Now that file areas and message areas require less disk storage space, it
  205. seems that sysops are adding more message and file areas than ever. And many
  206. of them are hitting the DOS 640K limit like a brick wall. We have been working
  207. on a solution to this problem (namely the OS/2 version), although we are
  208. also researching solutions for the DOS version and things are looking good. In
  209. the mean-time, fuss with QEMM and hang in there.
  210.  
  211.  
  212. SBBSFIDO
  213. --------
  214. The 's' switch mentioned in 1CTO20.DOC is not valid or necessary for SBBSFIDO.
  215. Please ignore the reference using it for "Fast Allocation".
  216.  
  217.  
  218. Synchronet BBS List in Online Access Magazine
  219. ---------------------------------------------
  220. If your BBS is in the BBS Database on our BBS, your system was included in
  221. a list of Synchronet systems published in a national publication known as
  222. "Online Access - BBS Edition". So when you start getting calls from users
  223. saying they heard about your system from Online Access, you'll know what
  224. they're talking about.
  225.  
  226. We hope you'll be pleased with the response of this "free advertising". We
  227. encourage the publication of our list and will continue to do so. So, if you
  228. don't want your BBS number spread around the globe, don't put it in our list :)
  229.  
  230. Rob Swindell
  231. Digital Dynamics
  232.  
  233. Voice: 714-529-6328
  234.   BBS: 714-529-9525
  235.   FAX: 714-529-9721
  236.  
  237. /* End of NOTE200A.TXT */
  238.